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Section 1 — Introduction 


Welcome to the Boston Community Information System — the Boston CommInS! We are pleased to 
welcome you as a participant in this experiment to test a new way of distributing world news and 
features from the New York Times and the Associated Press (AP) wire service directly to people's 
personal computers via radio waves. With our software and a special radio receiver connected to 
your IBM (or compatible) personal computer, you can receive up-to-the-minute information on the 
myriad topics carried by the New York Times and AP wire services, including world news, local 
events, financial reports (and some closing stock prices), business news, editorials, commentaries, 
features on the arts, and weather forecasts. With the Boston ComminS,:you may even receive 
information on these topics before its announcement on the radio or its publication in a newspaper! 


The Boston ComminS turns your computer into a personal information assistant that monitors the 
news as it happens. Acting on your instructions, your computer will “‘filter’’ this flow of information, 
saving the stories that match your list of interests. Thus, you can walk up to the system at any time, 
and browse through the stories that the system has saved for you. Because your personal computer 
can receive and filter much more information than you could read yourself, it can help you focus and 
enlarge your awareness of the world. You will probably find that the system consistently finds more 
articles of interest on certain subjects than you do.- 


For best results, we recommend that you leave your personal computer turned on with the Boston 
CommInS software running whenever you are not using your personal computer for another task. 
The radio station that carries our transmissions is on the air 20 hours per day. If you leave your 
system running overnight, it wiil be ready the next day with the latest news. Most news is transmitted 
several times a day, So you can use your personal computer for other tasks without fear that you will 
miss an important article. 


This User Manual is designed to tell you everything you need to know to set up and operate the 
equipment and software loaned to you. We have prepared this manual for new and experienced PC 
users alike. We hope the manual will answer all your questions about connecting our special digital 
receiver to your PC, about using the software for the first time, and about customizing the software for 
your personal use. If you have difficulties, try re-reading this manual, especially the appendix on 
trouble-shooting, but if the difficulties persist, do call us for assistance at the Boston CommInS 
‘hotline’, (617)-253-0007. 


Because this is an experiment, we are very much interested in your thoughtful evaluation of the 
Boston CommInS. Not only do we want your first impressions of the system, j.e. your ideas on making 
the system easier to use during the first few hours, but we also want your later impressions, i.e. your 
suggestions and advice (on all aspects of the system) from the perspective of an experienced user. 
To this end, we will send you a one-page questionnaire each month, which you should return to us 
promptly. In truth, we hope that you will send us additional information as the spirit moves you; we 
want to know your full thoughts on the system, not just your responses to the monthly questionnaire. 
In a sense, the monthly questionnaires represent a minimum of feedback and evaluation from you; 
please do send more if you wish. 


COMMINS USER MANUAL INTRODUCTION 


As a participant in this experiment, you have signed an agreement concerning your responsibilities. 
Note that you must abide by this agreement, in spirit and in letter, or you will be asked to return all 
loaned equipment and software to us immediately. 


We welcome you to this experiment to test the Boston ComminS, and we are looking forward to 
working with you in the coming months. 


Onl? 


Professor David K. Gifford 
Massachusetts Institute of Technology 
Cambridge, Massachusetts 

November 1985 
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Organization of this Manual 


This introduction is followed by three more sections, which describe, in turn: 
e the capabilities of the CommInS software, and how to use it; 
e the information services provided by the Boston Commins; and 
@ how to put together your own personalized ‘news filter’. 


There are five appendices. Appendix | is the most important one for new users: it describes how to 
connect the receiver to your PC, and how to install and run the software. Appendix Il is a trouble- 
shooting guide, and contains descriptions of common problems and their solutions. 


Appendix Ill is the reference section: all the commands are listed here. Finally, Appendix !V describes 
the files used by the system, and Appendix V contains a few words about the responsibilities of 
participants in the Boston ComminS experiment. 


How to Use this Manual 


First-time users should proceed in the following order: 

e First of all, you should read Appendix | ~- Getting Started and follow the instructions for 
unpacking the equipment, installing it, and installing the software. 

e After you install the hardware and software, you should read Section 2. Section 2 includes 
instructions for first-time users that you should follow. These instructions guide you through 
the section quickly and superficially, to give you a general idea of how to use the Commins 
software. 

e Next, you should skim Sections 3 and 4, to learn about the information services that are 
available, and to learn how to put together your own news filter. 

e Finally, you should turn back to Section 2, read the parts that you were asked to skip on first 
reading, and try out all the different commands. 


Start with ‘Appendix | — Getting Started’’. Good /uck! 


is) 
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Section 2 — Using the ComminS Software 
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Figure 2-1: The Screen Layout and the Window Selection Menu 


As shown in Figure 2-1, the CommInS software divides the screen of your PC into four separate areas: 
® The status line is the highlighted line at the top of the screen. In addition to the date and time, 
the status line indicates which window is displayed below, which line or summary in the window 
is selected (if any), which lines or summaries are shown, and how many lines or summaries the 
window contains. 
e The query line, also highlighted, is the third line from the bottom. The purpose of the query line 
is described in Section 2.1. 
e The message area occupies the bottom two lines of the screen. Messages from the system 
(such as acknowledgments and error messages) are displayed here. 
e The window display occupies the remainder of the screen. It is used to display the following 
five windows: 
o the filter window, which contains your news filter, 
o the summary window, which contains article summaries, 
o the article window, which contains articles, 
o the diagnostic window, which contains details about the system’s operation, and 
o the options window, which contains the setting of various controls that you can change. 
When the system starts up, it displays the filter window. To find out how to ask the system to display 
the other windows, press F10: this instructs the system to show the window selection menu (see 
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Figure 24), A menu is a highlighted box containing a list of commands, one of which (the se/ected 
command) appears on a contrasting background. You can use the | and 7 keys to select any 
command in a menu; when you press <Esc>, the selected command is executed. If you do not want to 
execute a command, you can select DO NOTHING, or you can press the shorthand key C-C. If you 
press a key other than |, T or <Esc>, the system will remove the menu and then act upon the key you 
pressed.? 


You can use the window selection menu (see Figure 2-1) to instruct the system to display any of the 
five windows. As an alternative, you can simply press the corresponding shorthand key shown in the 
menu (F1 for the filter window, F3 for the summary window, and so forth). The status line (at the top 
of the screen) always indicates which window is being shown. The shorthand keys work whether or 
not there is a menu on the screen; thus, you can a/ways ask the system to display any of the five 
windows by pressing F1, F3, F5, F7 or F9. If this is your first time using the system, you should take a 
look at the other windows before you read on. 


If a window contains more than one screenful of text, this is indicated in the status line. To see whole 
text of the window, use the scrol{ keys: 

<PgDn> Show the next page. 

<PgUp> Show the previous page. 

<Home> Show the first page of the window. 

<End> Show the last page of the window. 


In the filter window and the summary window, you can also use the the following keys: 


Shift: | Move forward one line (or summary) 
Shift-T Move back one line (or summary) 

1 Select the next line (or summary) 

T Select the previous line (or summary) 


Each of the five windows has its own set of commands: for example, the filter window has a command 
for adding new filter lines, the article window has a command for going to the next article, and so on. 
The commands for each window are listed in the command menu for that window. When you are 
looking at a window, press <Esc> to see the corresponding command menu. You can display all five 
command menus in turn by pressing F1 <Esc>, F3 <Esc>, F5 <Esc>, and so forth. Note that every 
command has a shorthand key, which is listed to the right of the command in the menu. 


For your protection, some commands (Such as DELETE ALL MATCHING ARTICLES) ask for confirmation 
before they do anything. When you execute such a command, a confirmation box appears on the 
screen. A confirmation box is a tiny menu with only two options: DO NOTHING and CONFIRM. Select 
CONFIRM and press <Esc> if you wish to go ahead (or use the shorthand A-Y); if you wish to cancel the 
command, execute the DO NOTHING command or use the shorthand C-C. 


‘When you press a key, the system usually responds right away. However, when the system is writing a new article on the 
disk, it responds only after the whole article has been written. 


*The prefix “C-" refers to the <Ctrl> key: for example, C-C means “hold down the <Ctri> key and press ¢”. Similarly, the 
prefix “A-” refers to the <AIb key: for example, A-Y means “hold down the <Alb key and press y”. 


3 : 
Thus, you can also remove a menu by pressing the space bar. 
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2.1— The Filter Window 
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Figure 2-2: The Filter Window and its Command Menu 


The CommiInS software monitors the information that comes in via the receiver, and ‘filters in” the 
articles that match your interests, based on the filter. Thus, the filter serves as your personal ‘‘interest 
profile’. The filter on the distribution disk serves only as an example to get you started — you will 
soon learn how to customize the filter for your personal use. 

Press Fi to see the filter window (see Figure 2-2). Each line in the filter corresponds to a specific 
topic. Each filter line is preceded by a number in parentheses, which indicates how many articles 
matching that line are on the disk.* 

One of the filter lines is highlighted: it is called the selected line.’ You can select any line in the filter 
by means of the scrol/ keys defined above.© When you select a particular line, the contents of that 
line appears on the query line so that you can use it as a query. If this is your first time using the 


4K there are two numbers in front of each filter line, as is the case in Figure 2-2, the number before the "/" is the number of 
matching articles. The second number is the budget for that filter line; budgets will be discussed shortly. 


51 none of the filter lines appear brighter than tne rest, press <Home> and adjust the brightness and contrast controls on 
your PC until the first filter line appears brighter than the rest. 


SB when you use the scroll keys, the system will select a different filter line if this is necessary to ensure that the selected line 
remains visible on the screen. 
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system, select a line for which the number of matching articles is not zero, and press <Enter>.” When 
you press <Enter>, the system processes the query on the query line, and displays summaries of the 
articles that match the query. The summary window is described in the next subsection. If this is your 
first time using the system, turn to the next subsection after you have pressed <Enter>. 


Because disk space and memory are limited, the system does not save all matching articles 
permanently. When the system runs out of space, it deletes old articles to make room for new ones. 
You can tell the system how many matching articles you would like to keep for each filter line by 
specifying a budget for each line. If this is your first time using the system, press F1 to see the filter 
list; then press F2 to display the budgets if they are not visible. For each filter line, the system will try 
to keep at /Jeast as many articles as the budget indicates, and perhaps more if there is enough room. 
You can change the budget of any filter line by selecting that filter line, and pressing ‘>’ to increase 
the budget, or ‘‘<”’ to decrease it. 


When the system needs to delete an article to make room for a new one, it will first attempt to delete 
one from a filter line that is ‘over budget’. If severa/ lines are over budget, an article will be deleted 
from the last such line in the filter. If all the filter lines are within their budgets, an article will be 
deleted from the last line in the filter that has matching articles. Because the system deletes articles 
from ihe bottom of the filter first, you should arrange your filter so that the topics that interest you 
most appear near the top. You can rearrange the lines in the filter by pressing A-U (or A-N) to move 
the selected line up (or down) in the filter. This is better than deleting the line and re-inserting it 
elsewhere, because when you delete the line, articles that match only that line will be deleted. 


To find out what you can do in the filter window, press F1 (to see the filter window), and press <Esc> 
to see the corresponding command menu (see Figure 2-2). You can execute any command in the 
menu by selecting it (using | and T) and pressing <Esc>, or you can use the shorthand keys. Most of 
the command names are self-explanatory; if this is your first time using the system, please go ahead 
and try out the various commands. A few of the commands are explained in more detail below. 


The SHOW SUMMARIES Command, with shorthand <Enter>, instructs the system to process the query 
on the query line. Usually, the query line contains a copy of the selected filter line. However, you can 
submit any query you like by editing the query line before you press <Enter>.® The query lanquage is 
described in Section 4. Note that while any valid query is permitted as a filter line, you can process 
only queries that contain only words and phrases that occur in the filter. 


You can customize the filter by adding and removing lines, by re-ordering lines, and by changing their 
budgets (see Section 4 — The Query Language). To add a new line to the filter, select a line at the 
point where you want to insert the new line, and press A-I. The system will create a new filter line, 
containing a copy of the query line. You can use the edit keys to edit the new filter line if you wish. 
When you are satisfied with your new filter line, press the <Enter> key to install it in the filter. If you 
change your mind and you decide that you do not want to add a line after all, press C-C. 


Ny none of the filter lines have any matching articles, turn to the Appendix on trouble-shooting. 


8the editing keys are described in Appendix /.3 — Editing Keys. 
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When you delete a filter line, the matching articles are also deleted. For this reason, the REMOVE 
CURRENT LINE Command requires confirmation. 


You can ‘mark’ a filter line so that the system will ring the bell when a matching article arrives. This is 
called ‘‘beep-on-arrival’’, and you can turn it on and off (for the selected filter line) by pressing A-1. 
Filter lines that have “beep-on-arrival’” set are identified by a musical note in the margin. You can 
also mark a filter line so that the system will print all articles matching that line as they arrive. This is 
called “print-on-arrival’’, and you can turn it on and off (for the selected filter line) by pressing A-2. 
Filter lines that have ‘“‘print-on-arrival"’ set are identified by the symbol Pt in the margin. Ifa line has 
both ‘‘beep”’ and ‘‘print’’ set, only the Pt symbol appears. 


The last line of the filter, displayed as an asterisk (*), is not really a filter line; it matches every article 
on the disk, and the number of articles matching it indicates how many articles are on the disk. The 
budget of this line is called the system budget, and it indicates the maximum number of articles that 
the system will keep. You can change the system budget just as you change the budget of a filter line, 
by pressing ‘>’ or ‘<’ or by executing the command CHANGE BUDGET OF CURRENT LINE. If you have a 
hard disk, you can limit the size of the \news directory by setting the system budget to, say, 100 
articles. The system budget is limited by the amount of free memory: when the system runs out of 
memory, it reduces the system budget accordingly. 


Except for articles that match one or more other lines as well. 
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2.2 — The Summary Window 
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Figure 2-3: The Summary Window and its Command Menu 


The summary window (see Figure 2-3) contains summaries of the articles that match a particular 
query or filter line. If this is your first time using the system, press F3 to see the summary window. 


Each article summary is preceded by a highlighted line containing: 

@ the date (and time) of the article, 

e the number of lines in the article, 

@ the priority of the article, and 

e the general subject area of the article. 
If the article has not yet been displayed, the header line also contains the words (not read). The 
header line is followed by a brief ‘‘summary”’ of the article." The summaries are listed in reverse 
chronological order, i.e. the summary of the most recent article is listed first. 


The arrow to the left of the summaries points to the selected summary. You can select any summary 
in the summary window using the scroll keys." 


We do not employ someone to read the articles and write summaries. Instead, the system automatically extracts the first 
sentence of each article to display as the summary. In most news articles, the first sentence provides a reasonably good 
summary. Sometimes, as you will discover, it doesn't. And sometimes our automatic procedure for finding the first sentence 


doesn’t work. 

1 : si ‘ nee 

: When you use the scroll keys, the system will select a different summary if this is necessary to ensure that the arrow 
remains visible on the screan. 


10 


USING THE COMMINS SOFTWARE COMMINS USER MANUAL 


To find out what you can do in the summary window, press <Esc> to see the command menu (see 
Figure 2-3). The command menu contains the following commands: 

e@ DO NOTHING (with shorthand C-C) — this command removes the menu. 

@ SHOW WINDOW SELECTION MENU (F 10) —- this command shows the window selection menu; it is 
listed primarily to remind you of the shorthand key, F10. 

@ SHOW CURRENT ARTICLE (A-R) — use this command if you wish to read the article corresponding 
to the selected summary. If this is your first time using the system, you should select this 
command, press <Esc>, and turn to the next subsection. 

@ DELETE CURRENT ARTICLE (A-D) — this command deletes the article corresponding to the 
selected summary. It does not ask for confirmation. 

© DELETE ALL ARTICLES IN LIST (A-K) — this command deletes all the articles whose summaries are 
in the summary window. It will ask for confirmation first. The number of articles in the summary 
window is listed on the status line. 

@ PRINT CURRENT ARTICLE (A-P) — this command prints the article corresponding to the selected 
summary. It works only if your PC is equipped with a printer and the printer is turned on. 

@ PRINT ALL ARTICLES IN LIST (A-A) — this command prints ali the articles whose summaries are in 
the summary window. The number of articles in the summary window is listed on the status 
line. 

e@ EXIT TO DOS (A-X) — use this command if you want to turn off the PC or if you want to use the 
PC for something else. | 


Note: The summary window always contains the summaries from the last query precessed. Thus, 
even if you change the query line and press F3 again, the contents of the summary window will remain 
the same. The following two commands, which are listed in Section 2.1 — The Filter Window, are the 
only ones that create a new list of summaries: 

@ SHOW SUMMARIES 

@ SHOW FIRST ARTICLE 
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2.3— The Article Window 
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Figure 2-4: The Article Window and its Command Menu 


The article window (see Figure 2-4) is used to display articles. You can move up and down through 
the article using the scroll keys.’ If this is your first time using the system, press F5 to see the article 
window. 

Most articles contain several words that matched your filter. The first occurrence of each such word 
is highlighted, so you can scan an article quickly and determine why it matched the filter. This is 
useful because filter lines sometimes match out of context, filtering in articles that do not interest you 
at all. If a particular filter line matches a lot of articles that do not interest you, you may wish to make 
that filter line more ‘specific’ — this is explained in Section 4. 

To find out what you can do in the article window, press F5 (to see the article window), and press 
<Esc> to see the corresponding command menu (see Figure 2-4). 

SHOW NEXT ARTICLE is probably the most useful command. It instructs the system to display the article 
corresponding te the next summary in the summary window. If there are no more articles, the system 
puts a message in the message area, and displays the filter window. 

The ComminS software remembers which articles it has displayed. If you don’t want to see the same 
article twice, you can use the command SHOW NEXT UNREAD ARTICLE instead of SHOW NEXT ARTICLE. 


When you have read an article, you can delete it (to make room for new articles). Depending on what 


12 pan», <PygUp>, <Hame>, <End>, etc. 
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you want to do next, you can use the command DELETE, THEN SHOW NEXT ARTICLE, the command 
DELETE, THEN SHOW NEXT UNREAD (ARTICLE), or the command DELETE, THEN SHOW SUMMARIES. 


If your PC is equipped with a printer, you can print the article using the command PRINT CURRENT 
ARTICLE. 


Finally, you can use the command EXIT To DOS if you want to turn off the PC or if you want to use the 
PC for something else. 


Note for first-time users: 

if this is your first time using the system, we recommend that you: 

e turn to Section 3 — Databases and Services, and skim it to learn about the information 
services that are available through the Boston Commin§S; 

e skim Section 4 — The Query Language, to find out how to put together a news filter 
that filters in the information you are interested in; 

e after that, turn back to the beginning of this section (Section 2), read the parts that you 
were asked to skip on first reading, and try out all the different commands. 
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2.4— The Diagnostic Window 
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Figure 2-5: The Diagnostic Window and its Command Menu 


The diagnostic window contains information about the operation of the Boston Commins software. 
This information is updated continually. If your system is working correctly, you should have no need 
for this window at all. If this is your first time using the system, press F7 to see the diagnostic window. 


In the Boston ComminS radio transmissions, each article is divided into ‘packets’ that are 
transmitted separately. Each packet is ‘checksummed’ to permit error detection, and broadcast twice 
to permit error recovery. The ComminS software receives packets, verifies the checksum, and 
discards duplicate packets. The most important indicator of system performance is the number of 
“intact packets” received. During normal operation, the number of ‘intact packets’’ received should 
be increasing steadily, at a rate of about three per second, occasionally interrupted by brief pauses 
that are followed by rapid catching up. If the number of “intact packets” is not increasing, turn to the 
trouble-shooting guide in Appendix Il. 


All “intact packets”’ are “‘accepted”’, unless they are “duplications” of packets received earlier. Since 
every packet is transmitted twice, the number of ‘‘duplications” should be approximately equal to the 
number of ‘‘accepted”’ packets. 

If a packet is “unframed”, or contains a ‘‘checksum error’”’, it is not received ‘intact’. These numbers 
are an indication of reception quality. If your receiver is functioning well, the number of “unframed” 
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packets and ‘checksum errors’ should be very small, probably less than ten per day.'3 When the 
radio station is off the air (usually from 2 am to 6 am) the number of bad packets will increase. 


You can get a sense of the percentage of articles that actually match your filter by comparing the 
number of ‘articles matching the filter’ with the number of ‘articles broadcast since system startup”. 
The number of matching articles that are actually written to the disk is listed as ‘‘Articles accepted”’. 
The number of ‘Articles presently on disk”’ is the number of articles on the disk. 


For legal and policy reasons, all our information broadcasts are digitally encrypted. Different kinds of 
information are encrypted using different keys. The software distributed for this experiment contains 
keys for the New York Times and AP articles, as well as for system announcements. Articles that are 
intended for a limited audience (for example, personal mail) are encrypted using keys that are not 
distributed to the general public; when such articles are received, they are counted as ‘articles with 
unknown keys”’. 

if you instruct the system to print one or more articles, the number of ‘Articles currently in print 
queue” indicates how many articles remain to be printed. You can stop printing and clear the print 
queue at any time using the shorthand key A-Q. 

The bottom line in the Diagnostic window indicates the amount of free memcry, and the amount of 
unused stack space in each of the ‘forks’ (internal processes) of the program. 4 Mem is the total 
amount of memory that is not allocated. Memory is allocated for each filter line, and for each article 
on the disk. 

Rfrk is the amount of unused stack space in the receiver fork. The receiver fork receives data, checks 
packets, assembles them into articles, decrypts the articles, matches them against the filter, and 
writes new information to disk. 

Kfrk is the amount of unused stack space in the keyboard fork. The keyboard fork processes all 
keystrokes and commands. 

Cfrk is the amount of unused space in the clock fork. The clock fork is responsible for periodic 
processing, such as updating the clock in the upper right corner of the screen. 


'3there will usually be at least one “unframed” packet, because when you start up the Boston ComminS program, odds are 
that it will receive the end of a packet before it begins to receive whole packets. 


'4this information is provided primarily for the system implementors; there are no “user-serviceable parts" within the 


Boston ComminS software. However, if the amount of free memory gets very small (under 100 for the forks, under 1000 for the 
free memory) you may encounter unexpected problems. This should net happen during normal operation of the system. 
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2.5— The Options Window 


Beaiees Pea oe: nov 11, 17:24 


The ¢ ver 15 on 


Budget are on 

Recelver 16 an port | 

The error bell is off 

Print queue lengths: © articles 


Figure 2-6: The Options Window and its Command Menu 


The options window shows the setting of various controls that you can change. If this is your first 
time using the system, press F9 to see the options window. 

The first line in the options window indicates whether the receiver is on or off. You can turn the 
receiver on or off with the command TURN RECEIVER ON/OFF, or with the shorthand A-O. When you 
shut the receiver off, the system will respond to your commands more promptly, because it won't be 
writing articles to the disk. On the other hand, you won't receive any new articles. If you decide to 
turn the receiver off so you can read articles without being interrupted, don’t forget to turn the 
receiver back on when you’re done. 

Line two of the options window indicates whether or not the budgets are being displayed in the filter 
window. You can turn the budget display on or off with the command TURN BUDGET DISPLAY ON/OFF, 
or with the shorthand F2. 

Line three indicates whether the program is listening for articles on port 1 or on port 2. If you have 
two serial ports, you can swiich the program to the other port with the command RECEIVE DATA FROM 
PORT 1/PORT 2 (or with the shorthand A-V).'° 

Line four indicates whether or not the ‘error bell’ is on. When the error bell is on, the system will 
‘beep’ whenever it receives a packet that is not ‘intact’. You can use the error bell to help you find the 


vou can also select a port when you start up the program: see Appendix 1.5.1 -— Starting the Commins Program. 
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best antenna placement. 


The last line in the options window indicates how many articles are waiting to be printed. To stop 
printing and empty the print queue, use the command STOP PRINTING AND EMPTY QUEUE or press A-Q. 


Note that even though this command menu is only available in the options window, the shorthand 
keys described here may be pressed at any time. 


17 


COMMINS USER MANUAL DATABASES AND SERVICES 


Section 3 — Databases and Services 


The Boston ComminS provides you with access to two major databases: 
@ the text of the New York Times, and 
e the Associated Press (AP) news wire. 


The New York Times service includes the complete text of the articles that appear in that newspaper. 
The AP service provides articles on a wide variety of topics. Because the New York Times is a New 
York paper, it does not carry local news for the Boston area. However, the AP service provides 
extensive Boston and New England coverage. 


The New York Times and AP databases are founded on different philosophies. The New York Times 
provides highly polished and readable news stories, corresponding to the printed version of the New 
York Times. Developing news stories are usually updated once a day. The AP service, on the other 
hand, provides up to the minute reports on breaking news stories, as well as corrections, updates, 
and occasional retractions of previous stories. Thus, you can expect to get different kinds of 
information from these different sources. 


3.1 — Fields 

Ail news articles follow the same standard format: an article consists of several fields, including the 
TEXT field. Section 4 describes how to take advantage of the information in the various fields when 
you put together your personal news filter. 


The set of fields is fixed; the use of the various fields is described below. For an example of how the 
fields are used, just look at any article. 


TYPE The TYPE field of an article identifies the source of the article. There are three types of 
articles: "nyt" (New York Times), "ap" (Associated Press), and “cis" (announcements 
from the Boston Community Information System). As we expand our information 
services, new article types may appear. 


DATE The DATE field indicates the date and time at which article was written. 


CATEGORY The CATEGORY field identifies the general subject area of an article. The categories used 
by the New York Times and AP editors are described in the next subsection. 


AUTHOR The AUTHOR field identifies the author of an article. This field is sometimes left blank by 
the originating information source. Occasionally, the author of an article is identified by a 
by-line in the TEXT field of the article. 

PRIORITY The PRIORITY field indicates the priority of the article, as classified by the originating 
information source. The PRIORITY field of an article contains one the following words or 


phrases: 

flash the highest priority; it is seldom used 

bulletin the priority level of prime news; it is also used for corrections, 
updates, and occasional retractions of previous stories 

urgent the priority level of important news 

regular the priority level of routine news 
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deferred 


Weekday advance 
Sunday advance 
reruns 
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the lowest priority level; used for delayed sending of a completed 
story 

material for a future weekday 

material for a future Sunday 

reruns 


SUBJECT The SUBJECT field contains a subject identifier that is assigned by the originating 
information source. Certain subject identifiers are used consistently; some of these are 
listed in Section 3.3. Some articles are actually listings of upcoming articles, and they 
give the subject identifier for each upcoming article (for example, "REAGAN-SPEECH"). 
If you are interested in such an article, add a filter line of the form (subject: 
"reagan-speech" ) to your filter and your system wil! catch the article. 


TITLE The TITLE field contains the title of the article, if any. Most articles do not have titles. 


TEXT The TExT field contains the text of the article itself. 


3.2 — Categories 


As will be explained in Section 4 — The Query Language, a filter line or query of the form 
(category: <something>) matches articles whose CATEGORY field contains <something>. The 
CATEGORY field is very useful, because the New York Times and AP editors put every article in an 
appropriate category. The following is a complete list of the categories used. 


General Domestic News 
Washington News 


International News 
Financial 


Features 
Lifestyle 
Entertainment and Culture 


Racing Results and Entries 
Sports 

Individual Sports Scores 
Commentary 

Travel 

Multiple Categories 


Presidential Election 


Domestic news, except for news from Washington D.C. 

News concerning national politics, the United States 
government, actions of the President, and congressional 
decisions 

News about foreign events, including articles originating at the 
United Nations headquarters 

Business news, financial indicators, and some stock market 
information 

Feature stories 

Social news 

Articles on entertainment, culture, and the arts, including reviews 
of movies, plays, books, and television programs 

Upcoming horse races as well as results 

Sports features and scores 

Selected box scores 

Editorials and columns 

Travel information and human interest stories involving travel 
Articles consisting of segments that belong in different 
categories; frequently used for announcements of upcoming 
articles 

Election coverage (when applicable) 
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Our information sources provide a variety of information, such as news summaries, on a regular basis. 
Information of this kind is identified using the SUBJECT field; for example, the query (subject: 
newssummary) matches the New York Times news summary, as well as various kinds of AP news 
summaries. In the descriptions below, (NYT) refers to material from the New York Times, (AP) refers 
to material from the Associated Press. The following subject identifiers are used consistently by our 


information sources: 


arts 

60 minute gourmet 
bba 

berkow column 
bestsellers 
bizweek 

bkc 

bonds 

book review 
booktalk 

briefing 

business digest 
business highlights 
business mirror 
calendar 


capitol ideas 
careers 

cheese eggs 
claiborne 
colleges 
column 

comput* 
consumer column 
consumer rates 
credit 

credit rates 
databank 
deaths 

digest briefs 
economy 
editorial 
editorial rndp 
extandeds 
fashion* 


News about the arts (AP) 

What to do for dinner in one hour (NYT) 

American League Baseball (AP) 

Sports commentary (NYT) 

Hardcover bestseller list (NYT) 

Weekly business story (NYT) 

College Basketball (AP) 

Bond prices (AP) 

Reviews of new books (NYT) 

Column about books (NYT) 

Briefing on washington news and political events (NYT) 
Business news digest (AP) 

Business news highlights (AP) 
Column on business (AP) 

Calendar of political events or of crafts, performing arts, and openings in 
the New England area (AP) 

Column from Washington (AP) 

Features on interesting careers (NYT) 

Cheese and egg prices (AP) 

Cooking with Craig Claiborne (NYT) 

Stories on college sports (NYT) 

Columns from the New York Times 

Various columns about computers, computing etc. (NYT) 
Consumer advocacy column (NYT) 

Consumer credit rates (NYT) 

Reports on commercial credit markets (NYT) 
Present commercial credit rates (NYT) 

National economic indicators (NYT) 

Obituaries (AP) 

Well-edited news summaries (AP) 

Information and articles about the US economy (AP) 
Editorials from the New York Times 

Editorials from New England papers (AP) 

Three-day extended weather forecasts (AP) 

Articles about fashion (NYT) 
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fbc 
fbn 
finbriefs 
findigest 


followups 
foreign affairs 
foreign briefs 
foreign exchange 
frontpage 
global temps 
gov finances 
hkn 

hko 

homev ideo 
indexes 
industry news 
kitchen 
kisselgoff dance 
lewis column 
mail order 
market 
marketplace 
mass digest 
Mass lottery 
matchups 
mortgage 

movie* 


movie notes 
movie review 
names news 
nasdaq 

news digest 
newssummary 


obits 
oly 
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College football (AP) 

Professional football (National league) (AP) 

Collections of short news items about business and finance (NYT) 

A daily digest of top financial news from the New York Times. This digest 
is identical to the business digest on the front page of the New York Times 
business section. 

Follow up on the news (NYT) 

Foreign affairs column (NYT) 

Foreign news briefs (NYT) 

Foreign exchange rates (AP) 

A daily description of the layout of the front page of the New York Times 
Temperatures around the world (AP) 

Figures on Government spending and debt (AP) 

National Hockey (AP) 

American League Hockey (AP) 

Recent home videotape releases (NYT) 

New York and American Stock Exchange indexes (AP) 

Business news briefs (AP) 

A column on kitchen equipment (NYT) 

A weekly column on dance (NYT) 

Anthony Lewis’ column (NYT) 

Mail order suggestions (NYT) 

A daily report on the stock market (NYT) 

Wall street news (NYT) 

Massachusetts news digest (AP) 

Massachuseits daily lottery results (AP) 

Pre-game analysis of upcoming sporting events (NYT) 

Articles about mortgages (NYT) 

Movie reviews and features about movies, including columns by Maslin 
and Canby (NYT) 

Movie column (NYT) 

Movie reviews (NYT) 

People in the news (AP) 

Selected over-the-counter stock prices (AP) 

A capsule summary of top national news stories from the AP. 

A capsule summary of top news stories from either the AP or the New York 
Times. The New York Times news Summary Comes out once a day around 
midnight, and is identical to the news summary that appears on the first 
page of the B section of the printed paper. Use the query (type: nyt) 
(subject: newssummary) for this summary. The AP summarizes local 
news many times a day. 

Obituaries (NYT) 

Olympics coverage {AP) 
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on language Column by William Safire on the English language (NYT) 
outdoors Column on outdoor activities (NYT) 

patents Patents of special interest that have recently issued (NYT) 
paperbacks Paperback bestseller list (NYT) 

people Column on people in the news (AP) 

personal finance Column on personal finance (NYT) 

personal health Column on personal health (NYT) 

pop Articles on popular music (NYT) 

practical traveller Travel advice (NYT) 

produce Boston wholesale produce prices (AP) 

prospects Financial prospects for particular business sectors (NYT) 
quest ionbox Sports questions and answers (NYT) 

quotes Notable quotations (AP) 

racing Horse racing news (NYT) 

records Recent classical record releases (NYT) 

reston column James Reston’s column (NYT) 

russell art John Russell's art column (NYT) 

safire column Column by William Safire that is not "On Language” (NYT) 
Science q a Science questions and answers (NYT) 

science watch Short summaries of recent scientific news (NYT) 

scotus Supreme Court (of the United States) news (AP) 
scouting Stories on sports players (NYT) 

silk column Financial commentary by Leonard Silk (NYT) 

ski Column on skiing (NYT) 

sports briefs Brief stories about sports (AP) 

tabletalk Food column (NYT) 

technology Reports on new and interesting technologies (NYT) 
telerate Interest rates, including T-bills, Eurodollar, Federal discount rate etc. (AP) 
theater Articles about and reviews of the theater (NYT) 
transactions New York Stock Exchange trading volume (AP) 

travel notes Vacation ideas (NYT) 

travelers forecast* Weather forecasts for selected cities (AP) 

tv review Reviews of upcoming television programs (NYT) 

tv tonight Tonight's TV programs; sent three days in advance (NYT) 
tv weekend Weekend television (NYT) 

vecsey column Sports column (NYT) 

video Column on home videotapes (NYT) 

wall street Reports on Wall Street trading (AP) 

washington brief Short news items from Washington D.C. (AP) 

watch Upcoming business events to watch (NYT) 

wea temps Temperatures and weather from major cities around the country (AP) 
weatherpage Summary of weather around the country (NYT) 

wicker column Tom Wicker’s column (NYT) 
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wine* Column on wine (NYT) 


3.4— Useful Queries 
In addition to the subject specifiers above, the following queries will provide you with useful 
information. 


boston vicinity forecast* Local weather forecast (AP) 


massachusetts daybook Newsworthy upcoming events in Massachusetts (AP) 
ski conditions Ski conditions at all local ski resorts (AP) 
(title: week review) Articles from the New York Times “week in review” section 
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Section 4— The Query Language 


The ComminS software lets you describe articles that interest you using a simple language, called the 
query lanquage. The query language is primarily used for filter lines, but you can also type queries 
directly into the query line. As described in Section 2, the system uses your filter to determine which 
articles to save for you. Using the query language, you can tell the system what articles interest you, 
in terms of their contents, Source, author, subject, and a variety of other attributes. In this section, we 
explain the query language, starting with the simplest possible queries. 


The simplest possible query is a single word. Imagine, for example, that you are interested in all 
articles that contain the word "peace". The corresponding query is the word peace. If you are 
interested in all articles that contain the words "war" and "peace", the corresponding query could be 
war and peace,war & peace, or simply war peace. Thus, you can combine two simple queries 
into a more specific query by means of and, & or concatenation. 


Next, imagine that you are interested in all articles that mentioned the Supreme Court. You could use 
the query supreme court, but this query matches all articles that contain the words "supreme" and 
"court", regardless of whether they appear consecutively. To indicate that the words "supreme" and 
"court" must appear consecutively as a phrase, simply put them in quotes: "Supreme Court". A 
phrase may contain any number of words. 


Next, imagine that you are interested in all articles about computers, computing, computation, and so 
on. To catch all these articles, use the query comput*: it matches all articles that contain one or 
more words beginning with the letters "comput". These queries are called stem queries, because 
they match any word that begins with a specified stem. There are two resirictions on stem queries: a 
stem query may not appear inside a phrase, and the stem must be at least two characters long. 


The following convention applies to all queries: uppercase and lowercase letters are considered the 
same, and all punctuation characters in articles are treated as spaces, except for apostrophes, which 
are ignored. The system will not accept queries that contain punctuation characters, except for 
hyphens, which are treated as spaces. Thus, the query rogers matches the following words: 
"rogers", "Rogers", "Roger's", "Rogers’'", and so forth. The queries "Space cadet" and 
"space-cadet" maich the following phrases: "space-cadet", "Space Cadet", etc. 


Next, imagine that you are interested in articles by a certain author, say John Smith. You could use 
the query Smith, but it matches every article that contains the word "smith", regardless of the 
context in which it appears. To rule out all these extra articles, use the query (author: smith); it 
matches all articles that have an AUTHOR field containing the word "smith". Queries of this kind are 
Called field-specitic queries; the possible fields (besides AUTHOR) are listed in Section 3.1. Other 
examples of field-specific queries include (subject: newssummary) and (type: cis). 


Above, we showed how to combine two queries into a more specific query by means of and, &, or 
concatenation. In combination with field-specific queries, this combining rule is very useful; for 
example, the query ibm (category: financial) matches all articles that contain the word "ibm" 
and have a CATEGORY field containing the word "financial". 


The following examples illustrate the different kinds of queries, and the various ways in which they 
can be combined using and, or and not. 
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The Query 


peace 
"War and Peace" 
comput* 


ski* 


war and peace 
war & peace 
war peace 


war "and" peace 


war or peace 
war | peace 

not war 

~ war 

peace and (quiet or talks) 
(peace and quiet) or talks 


(subject: movie*) 


(author: smith (not john)) 


harvard (not (subject: football)) 
harvard (subject: (not football)) 
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Matches Articles that... 


..contain the word "peace" 
..contain the phrase "war and peace" 
..contain a word that begins with "comput", such 


as "computer", "computation" or 
“computability” 


..contain a word that begins with "ski", such as 


"ski", "skiing", "skid", “skin” or "skiascope" 


..contain the words "war" and "peace". The three 


queries shown to the left are equivalent. 


..contain the words “war", "and", and "peace" 


..contain either the word "war" or the word 


"peace". The two queries shown to the left are 
equivalent. 


.do not contain the word "war". The two queries 


shown to the left are equivalent. 


contain the word "peace" and either the word 


“quiet” or the word "talks" 


..contain the words "peace" and "quiet" or the 


word "talks" 


.. have a SUBJECT field containing a word that 


begins with "movie" 


. have an AUTHOR field containing the word 


“smith” but not the word "john" 


..contain the word "harvard" but do not have a 


SUBJECT field containing the word "football". 
The two queries shown to the left are equivalent. 


The following are some examples of invalid queries, along with the reasons why they are invalid: 


The Query 


“comput* languages" 
(author: (subject: smith)) 


Mr. Rogers' neighborhood 
(topic: reagan) 


(a or (b) orc 


Is Invalid Because... 


..a stem query may not appear within a phrase 
..2 field-specific query may not be nested inside 


another field-specific query 


..punctuation (such as periods and apostrophes) 


must be omitted from all queries 


.. TOPIC is not a valid field name. The valid field 


names are listed in Section 3.1. 


.. parentheses must be balanced 
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Appendix |— Getting Started 


Important 


The Boston ComminS hardware and software have been designed for use with an IBM 
PC™, XT™, or AT™ personal computer with the following minimal configuration: 

¢ a monochrome or graphics display card and monitor, 

e version 2.1 or 3.1 of the MS-DOS™ operating system, or a corresponding version of 

PC-DOS™, 

® one floppy disk drive, 

e 256 K (kilobytes) of RAM, and 

e one RS-232 serial port. 


The Boston Comm!nS hardware and software may also work with 100-percent compatible 
machines made by other manufacturers, provided that they have at least the 
configuration listed above. 


Introduction 


This appendix explains how to unpack the equipment and how to start using the hardware and 
software for the Boston CommiInS. It covers the following topics: 

e unpacking the equipment, . 

@ installing the hardware, 

e installing the software, 

e running the Commins program, and 

e stopping the Commins program. 


Please read and follow these steps in order, even though you may have years of experience with 
microcomputers and/or communications. 


1.14 — Unpacking the Equipment 
All the equipment, software and documentation for the Boston ComminS is packaged together. Each 
package should contain the following: 
e One receiver — an aluminum box with a signal strength meter, three connectors, and an MIT 
equipment tag (wrapped in bubble wrap) 
e One power supply (AC adaptor) — a black object (packaged in a white box) with prongs that 
can be plugged into an ordinary outlet (110 volt AC) 
e One antenna — a flat, translucent ribbon cable in the shape of a large "T", with a special 
connector at the bottom of the "T" 
e One RS-232 cable — a gray, 20-foot cable with a 25-pin connector at one end and a “phono” 
plug at the other end 
e One distribution disk — a standard 5% inch floppy disk, packed inside the user manual 
e One user manual — you're reading it. 
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Antenna 


Receiver 


Power Cord 


20-foot RS-232 Cable 


Connector Panel on Personal Computer 


| off 


Figure 1-1: Installation Diagram 
Place the contents of the distribution package on a table, and make sure you have received all of the 
above items. !f one or more items are missing, call the Boston ComminS ‘hotline’ at (617)-253-0007. 
Please save the box and packing materials for when you return the equipment to us at the end of this 
experiment. 


1.2 — Installing the Hardware 

Note: Please read this section once before you ein to put the equipment together. 

Positioning the Equipment 

The receiver, power supply, antenna, and cables can be arranged in any way that suits you, provided 
that they can be plugged into each other (see Figure !-1). Place the antenna near a window, 
preferably on the side of your building nearest Boston’s Back Bay (the Prudential Tower, to be exact). 
Referring to Figure I-1, position the receiver so that (i) it can be plugged into the antenna, (ii) the 
6-foot power cable can reach an ordinary outlet (110 volt AC) and (iii) the 20-foot RS-232 signal cable 
can reach your personal computer. 

Power 

Plug the power supply (AC adaptor) cable into an ordinary outlet (110 volt AC). Plug the other end of 
the power cord into the matching connector on the receiver. 

RS-232 Cable 


Plug the gray “phono” plug at the end of the 20-foot RS-232 cable into the matching connector on 
the receiver. Then plug the 25-pin RS-232 connector at the other end of this cable into the RS-232 
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serial port of your computer. For most installations, this description suffices. However, two unusual 
situations may apply to you: 
olf you have more than one RS-232 port on your personal computer, you must know which is 
port 1 and which is port 2. Normally, the Commins software expects the receiver to be 
connected to port 1, but either port 1 or port 2 may be used. 
e If you have an IBM AT™ computer with a 9-pin serial port connector, you will need an adaptor 
cable that lets you connect the 25-pin RS-232 connector to the socket on the AT’s rear panel. 


Receiver 


Plug the antenna into the receiver. If you place the receiver near a window, be sure to protect it from 
rain and snow if you keep the window open. 


Antenna and Orientation 


Positioning the antenna properly is the most important part of installing the system. If the antenna is 
not in a good position, you may not get good reception. As discussed earlier, try to position the 
antenna near a window on the side of your building closest to Boston’s Back Bay. Our transmitter is 
located atop of the Prudential Building. 


Note that the antenna looks like a '"T" — keep the top part of the T straight and taut. We have found 
that in most locations the best results are achieved when the top of the "T" is kept horizontal. While 
keeping the top of the antenna horizontal, rotate the antenna until you find the orientation that 
maximizes the reading on the receiver's signal strength meter. For best results, do not hold the 
antenna while you read the signal strength meter. Once you have found the orientation that 
maximizes the meter reading, fix the antenna in this position. 


if you are returning to this section because of poor reception, try one of the following: 

e Tape the antenna to your window — remember to keep the top of the "T" fully extended — and 
check your reception. 

e Stand facing the Prudential Building and hold the antenna fully extended between your hands. 
Now lay the fully extended antenna down, fix it in this position, and check your reception. 

e Instead of using the antenna supplied in the package, you can use another antenna; antennas 
designed for VHF TV will work very well. If the antenna does not have a plug that fits the socket 
on the receiver, connect it to the two screw terminals on the black connector (balun) provided 
with the antenna in the package. The antenna should be pointed towards the Prudential 
building for best results. 


If neither of these suggestions help, call the Boston CommInS ‘hotline’ at (617)-253-0007. 
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1.3— Installing the software 


Note: Before you instal! the software, make sure that you are using version 2.1 or 3.1 of the 
MS-DOS™ operating system, or a corresponding version of PC-DOS™, 


Locate the Distribution Disk in the distribution package. Use the DOS "DIR" command to list the 
directory of the Distribution Disk. The disk should contain four files: 

e CIS.EXE 

e FILTER.TXT 

e HELP. TXT 

e KEYRING.TXT 
The instructions for installing the software depend on whether you have a hard-disk drive, two floppy 
disk drives, or only one floppy disk drive. Determine which of the following three sections is 
appropriate, and follow the instructions in that section. 
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1.3.1 — Installing the Software on a Hard Disk 
1. Insert the distribution disk into drive A. 
2. Make the hard disk the default drive: 
Cc: <Enter> 
Most hard disk systems use drive C to refer to the hard disk. If you have multiple hard 
disks, or your disk is known by a different drive letter, repiace C in the instructions by 
the drive of your choice. 
3. Build a directory for the Boston CommInS program, and change the current directory to be this 
new directory: 
mkdir \news <Enter> 
cd \news <Enter> 
Because the DOS file system limits the root directory to 64 files, the Boston CommInS 
data should be stored in a subdirectory. We recommend using a directory called 
\news. 
4. Copy the ComminsS files from the distribution disk: 
copy a:*.* <Enter> 
This command will copy four files: CIS.EXE, FILTER.TXT, HELP.TXT and 
KEYRING.TXT. 
5. Remove the distribution disk from the floppy disk drive, and store it in a safe place. 
Keep the distribution disk as a backup. 
6. Start the Community Information System program: 
cis <Enter> 
7. Turn to Appendix 1.4 — Running the ComminS Program. 
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1.3.2 — Installing the Software with Two Floppy Disk Drives 
1. Take a blank disk that has been formatted with the /S option. 
If you do not have a blank system disk handy, format a new disk now. Make sure the 
new disk is not write-protected: remove the piece of tape covering the write-protect 
notch on the side of the disk if necessary. 
2. Label this blank system disk "Boston ComminS Program". 
From now on, we will refer to this disk as the "program disk". 
3. Take another blank disk, this one formatted without the /S option. 
Use a disk formatted without the /S option, because it has more space for data 
storage. 
4. Label this second blank disk "Boston CommtinS Data". 
By keeping the data on a separate disk from the program, you will be able to store 
more information. From now on, we will refer to this disk as the "data disk". 
5. Insert the distribution disk in drive A. 
6. Insert the program disk in drive B. 
7. Copy the file CIS.EXE from the distribution disk onto the program disk: 
copy a:cis.exe Db: <Enter> 
8. Remove the program disk from drive B, and insert the data disk in drive B. 
9, Make drive B the default drive: 
b: <Enter> 
10. Build a directory for the Boston CommInS data, and change the current directory to be this new 
directory: , 
mkdir \news <Enter> 
cd \news <Enter> 
Because the DOS file system limits the root directory to 64 files, the Boston CommInS 
data should be stored in a subdirectory. We recommend using a directory called 
\news. 
11. Copy the ComminS text files from the distribution disk into the \news directory: 
copy a:*.txt <Enter>d 
This command will copy three files: FILTER.TXT, HELP.TXT and KEYRING. TXT. 
12. Remove the distribution disk from floppy disk drive A, and store it in a safe place. 
Keep the distribution disk as a backup. 
13. Insert the program disk in drive A. 
When you run the CommInS program, the program disk should be in drive A, and the 
data disk in drive B. 
14. Start the Community Information System program: 
a:cis <Enter> 
The program is on drive A, and the \news directory containing the data is on drive B. 
15. Turn to Appendix |.4 — Running the ComminS Program. 
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1.3.3 — Installing the Software with One Floppy Disk Drive 
1. Take a blank disk, formatted with the /S option. 
If you do not have a blank system disk handy, format a new disk now. Make sure the 
new disk is not write-protected: remove the piece of tape covering the write-protect 
notch on the side of the disk if necessary. 
2. Label the blank system disk "Boston CommInS”. 
From now on, we will refer to this disk as the "program disk". 
3. Insert the program disk in the floppy disk drive. 
4. Build a directory for the Boston ComminS data, and change the current directory to be this new 
directory: 
mkdir \news <Enter> 
cd \news <Enter> 
Because the DOS file system limits the root directory to 64 files, the Boston ComminS 
data should be stored in a subdirectory. We recommend using a directory called 
\news. 
5. Copy the CommiInS files from the distribution disk: 
copy b:*.* <Enter> 
You will be asked to remove the program disk and insert the distribution disk. This 
command will copy four files: CIS.EXE, FILTER.TXT, HELP.TXT and KEYRING.TXT. 
You may need to swap the two disks several times. 
6. Remove the distribution disk from the floppy disk drive, and store it in a safe place. 
Keep the distribution disk as a backup. 
7. Re-insert the program disk in the floppy disk drive. 
8. Start the Community Information System program: 
cis <Enter> 
9. Turn to Appendix !.4 — Running the CommiInS Program. 
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1.4— Running the CommtnS Program 

At this point, the Boston ComminS program should be running on your PC. Normally, the program 
assumes the receiver is connected to port 1. If your receiver is connected to port 2, hold down the 
<Alt> key and press V to switch the system to port 2. 


You should now be "on the air". News articles received by the system will be stored in the \news 
directory. To verify that the system is working, press F7 and wait until the highlighted line at the top of 
the screen displays the words ‘Diagnostic Window"’. If the system is working, it should be receiving 
“intact packets” at a rate of about three packets per second. Find the number of “intact packets” on 
the screen: it is displayed five lines above the highlighted line near the bottom of the screen. The 
number should be increasing steadily, at a rate of about three per second, occasionally interrupted by 
brief pauses that are followed by rapid catching up. If this is the case, everything is working; please 
turn to Section 2 — Using the Commins Software and follow the instructions for first-time users. 


If the number of intact packets is not changing, refer to the trouble-shooting guide in Appendix II. 


1.5— Starting and Stopping the ComminS Program 


1.5.1 — Starting the Commins Program 
The procedure for normal start-up depends on the hardware configuration of your personal 
computer: 
« If you have either a hard disk or a single floppy disk drive, use the cd command to change the 
current directory to the \news directory, and start the program by typing cis. 
e lf you have two floppy disk drives, place the CommlnS program disk in drive A, the CommIinS 
data disk in drive B, use the b: and cd commands to change the current directory to the \news 
directory on the data disk, and start the program by typing a: cis. 


If your receiver is connected to port 2, you can use the " -2" option to tell the program to listen to 
port 2 right from the start: 

cis -2 <Enter> 

or 

a:cis -2 <Enter> 
When you start the CommiInS program, it begins to receive data immediately. You should verify this 
by pressing the F7 key and checking to see that the number of “intact packets”’ is increasing. If the 
system is not receiving data, refer to trouble-shooting guide in Appendix Il. 


1.5.2 — Stopping the ComminS Program 

To stop the ComminS program, you should hold down the <Alt> key and press X, or execute the EXIT 
command that appears in every menu. This instructs the system to save its article directory on the 
disk and return to DOS. 
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Warning: 
Do not stop the ComminS program by turning off the power or by re-booting your PC. 
If you interrupt the program in this way, the files used by the system may be left in an 
inconsistent state. When this happens, the program must be re-started using the " -r" 
option (described below). 


1.6 — Restarting after a Crash or Accidental Shutdown 

If the hardware or software running the Boston CommInS fails or is inadvertently shut down without 
using the ExiT command, the files used by the system may be left in an inconsistent state. Depending 
on the cause of the problem, you may wish to consult the trouble-shooting guide in Appendix I. 


If the system crashes or is accidentally shut down, you should reboot the DOS operating system in 
one of the two standard ways — either (i) by turning your personal computer off for 30 seconds and 
turning it back on, or (ii) by simultaneously holding down the <Ctrl> and <Alt> keys and then pressing 
the <Del> key. We recommend the latter method, to minimize wear of the computer hardware. 


To restart the ComminS program, follow the instructions for normal start-up in Appendix 1.5.1, but 
invoke the CommInS program with the " -r" option: 

cis -r <Enter> 

or, if you are using Port 2: 

cis -2 -r <Enter> 
The "=r" option instructs the Commins program to re-build the ComminS directory file, 
CIS - DIR.TXT, by reading all the article files on the disk and comparing them with the filter in the filter 
file. During the rebuilding process, the system displays the names of the files as it reads them; when 
this is finished, the system starts up as usual. 
As always, the system should begin to receive data immediately. You should verify this by pressing 
the F7 key and checking to see that the number of “intact packets” is increasing. If the number of 
“intact packets” is not changing, refer to trouble-shooting guide in Appendix Il. 
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Appendix Il — Trouble-shooting Guide 
if you are having trouble installing or using the system, check this list of common problems, 
symptoms, and solutions. If you cannot resolve the problem, call the Boston Commins ‘hotline’ at 
(617)-253-0007. If none of the consultants are available, please leave a message on the answering 
machine and someone will call you back. 


TROUBLE- SHOOTING GUIDE 


Please report ‘crashes’ (defined below) to the Boston CommiInS ‘hotline’; try to describe as many of 
the keystrokes and system actions leading up to the crash as you remember. 


Symptom 


Possible Problem 


The program does not start up, 
and does not respond to the 
keyboard. 


Not enough memory in your PC. 
(You need at least 256 K of 
RAM in order to run the 
Boston CommInS program.) 


Solution 


Install more memory. 


The program ‘freezes’ while 
starting up, and does not 
respond to the keyboard. 


The program stops responding 
to the keyboard. 


The program prints a "Fatal 
Error” message when 
starting up. 


The program exits to DOS 
unexpectedly. 


Some previous program left the 
PC in an unusable state 
(probably because of 
disorderly termination). 


The program has crashed. 


The system files are in an 
inconsistent state (perhaps 
because of a previous crash 
or accidental shutdown). 


The program got into a situation 
that was considered 
impossible, and crashed. 


(continued) 


Re-boot the PC and re-start the 
program. 


Re-boot the PC and restart the 
program using the command 
"cis -r". Please report the 
crash to the Boston 
Commin$S ‘hotline’. 


Re-start the program using the 
command "cis -r" (See 
Appendix 1.6). 


The file STDOUT.TXT will 
contain an error message. 
Please record this message, 
and when you report the 
crash to the Boston 
ComminS ‘hotline’, report the 
error message as well. Re- 
boot the PC and restart the 
program using the command 
"cis -r". 


TROUBLE-SHOOTING GUIDE 


Symptom 


The number of ‘intact packets” 
(in the diagnostic window) 
does not change. 


The number of “intact packets” 
(in the diagnostic window) 
does not change. 


Possible Problem 
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Solution 


The receiver is not connected. 


The program is listening to the 
wrong serial port. 


Make sure that the receiver is 
plugged in, and that the 
cable between the receiver 
and the personal! computer is 
connected. 


Either type A-V to instruct the 
program to listen to the other 
port, or connect the receiver 
to the other port. 


The number of “intact packets”’ 
(in the diagnostic window) 
does not change. 


The number of ‘articles 
received” (in the diagnostic 
windaw) does not change. 
The number of ‘unframed 
packets” and/or the number 
of ‘checksum errors” are 
increasing. 


The number of ‘articles 
received” (in the diagnostic 
window) is increasing, but 
the number of “matching 
articles” does not change. 


The number of “‘matching 
articles” (in the diagnostic 
window) does not change. 
The number of ‘‘articles 
received” and the number of 
“articles with unknown keys” 
are increasing at the same 
rate. 


Occasional periods of poor 
reception. 


The radio station is off the air. 


Poor reception. 


The program does not have a 
filter. 


The program does not have a 
key ring. 


Radio interference. 


Our data transmissions are 
carried by WERS Boston, FM 
88.9. WERS is generally off 
the air from 2:00 until 6:00 
am. Listen to WERS ona 
regular FM radio, and wait 
until it comes back on the air. 


Refer to the discussion on 
"Antenna and Orientation" in 
Appendix 1.2 — Installing The 
Hardware. 


Either re-start the programina 
directory that has a filter file 
(FILTER.TXT), or insert one 
or more filter lines into the 
tilter window. 


Copy the KEYRING.TXT file 
from the distribution disk into 
the \news directory, and re- 
start the program. 


Move the receiver, antenna, and 
PC away from other electrical 
equipment. 


a A 
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Appendix II|L— Summary of Commands 


Hl.1 — Special Function Keys 
The following keys on the PC keyboard have special meaning to the Commins software: 


F10 


<Esc> 


<Enter> 


The F10 key (shorthand for the command SHOW WINDOW SELECTION MENU) instructs 
the system to display the window selection menu. 

The <Esc> key instructs the system to display the command menu for the current 
window (see Section 2 — Using the ComminS Software). When there is a menu on 
the screen, the <Esc> key instructs the system to execute the selected command. 
The <Enter> key (shorthand for the command SHOW SUMMARIES) instructs the 
system to process the query on the query line and to display summaries of the 
matching articles (see Section 2.1 — The Filter Window). 


HWl.2— Scroll Keys 
The following keys can be used to scroll through a window: 


<PgDn> 
<PgUp> 
<Home> 
<End> 
L 

T 
Shift- | 
Shift-T 


Show the next page 

Show the previous page 

Show the first page of the window 
Show the last page of the window 
Select the next line (or summary) 
Select the previous line (or summary) 
Move forward one line (or summary) 
Move back one line (or summary) 


111.38 — Editing Keys 

The following keys can be used to edit the query line. They can also be used in the ‘edit boxes’ 
created by the commands CHANGE BUDGET OF CURRENT LINE and INSERT A NEW LINE. Note: the 
<Backspace> key is the key with a left arrow (+-) on a gray background. 


<Backspace> delete the character before the cursor 


C-W 

C-D 

C-K 
<Deb 
+orC-B 
+ or C-F 
C-A 

C-E 


delete the word before the cursor 

delete the character after the cursor 

delete everything after the cursor 

delete the entire line 

move the cursor to the left 

move the cursor to the right 

move the cursor to the beginning of the line 
move the cursor to the end of the line 


SUMMARY OF COMMANDS 


il.4— Alphabetical Listing of Commands 


COMMINS USER MANUAL 


The following is an alphabetical listing of the commands recognized by the ComminS software, along 
with their shorthand keys and the menu(s) in which each command is listed.'© The shorthand keys for 
the commands listed in the window selection menu and the options window command menu are 
available in every window; these keys are marked with an asterisk. All other shorthand keys are 
available in a given window only if the corresponding command is listed in the command menu for 


that window. 
Name of Command Shorthand 

CHANGE BUDGET OF CURRENT LINE A-B 
DELETE ALL ARTICLES IN LIST A-K 
DELETE ALL MATCHING ARTICLES A-K 
DELETE CURRENT ARTICLE A-D 
DELETE, THEN SHOW NEXT ARTICLE A-D 
DELETE, THEN SHOW NEXT UNREAD A-J 
DELETE, THEN SHOW SUMMARIES A-M 

DO NOTHING C-C * 
EXIT TO DOS A-X * 
INSERT A NEW LINE A-| 

MOVE CURRENT LINE DOWN A-N 
MOVE CURRENT LINE UP A-U 
PRINT ALL ARTICLES IN LIST A-A 
PRINT ALL MATCHING ARTICLES _ A-A 
PRINT CURRENT ARTICLE A-P 
PRINT CURRENT ARTICLE A-P 
RECEIVE DATA FROM PORT 1/PORT 2 A-V - 
REMOVE CURRENT LINE A-W 
SHOW ARTICLE WINDOW F5 be 
SHOW CURRENT ARTICLE A-R 
SHOW DIAGNOSTIC WINDOW F7 * 
SHOW FILTER WINDOW F1 * 
SHOW FIRST ARTICLE A-R 
SHOW NEXT ARTICLE A-N 
SHOW NEXT UNREAD ARTICLE A-Z 
SHOW OPTIONS WINDOW F9 ‘ 
SHOW SUMMARIES <Enter> * 
SHOW SUMMARY WINDOW F3 o 
SHOW (THE) WINDOW SELECTION MENU = F10 ig 
STOP PRINTING AND EMPTY QUEUE AQ * 
TURN BEEP-ON- ARRIVAL ON/OFF A-1 
TURN BUDGET DISPLAY ON/OFF F2 . 
TURN ERROR BELL ON/OFF A-E ; 
TURN PRINT-ON-ARRIVAL ON/OFF A-2 
TURN RECEIVER ON/OFF A-O * 


Listed in: 


filter window command menu 
summary window command menu 
filter window command menu 
summary window command menu 
article window command menu 
article window command menu 
article window command menu 
every menu 

every menu 

filter window command menu 
filter window command menu 
filter window command menu 
summary window command menu 
filter window command menu 
filter window command menu 
summary window command menu 
options window command menu 
filter window command menu 
window selection menu 

summary window command menu 
window selection menu 

window selection menu 

filter window command menu 
articie window command menu 
article window command menu 
window selection menu 

filter window command menu 
window selection menu 

every menu 

options window command menu 
filter window command menu 
options window command menu 
options window command menu 
filter window command menu 
options window command menu 


ware prefix A-” refers to the <AlD key: for example, A-B means “hold down the <AID key and press b". Similarly, the 
prefix “C-"' refers to the <CtrD key: for example, C-C means “hold down the <Ctrl> key and press c™. 
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Appendix IV — Files used by the system 


IV.1 — The ComminS Directory File 

The ComminS directory file, CIS—DIR.TXT, contains information about the articles on the disk: it 
contains an index, which is used to speed up the processing of queries, and it contains summaries of 
the articles, so that these can be displayed without delay. It also contains a list of articles that you 
have deleted, so that these articles can be filtered out if they are received again. 


When the program is running, the contents of the directory file is stored in memory; it is saved on the 
disk only when you exit from the program. This explains why the program should always be stopped 
using the EXIT command. If the directory file is missing, the program should be started with the " -r" 
option (see Appendix |.6 — Restarting after a Crash or Accidental Shutdown). 


1V.2 — The Filter File 

The filter file, FILTER.TXT, contains your personal filter. in this file, each filter line is stored as a 
separate line, along with two numbers: the first number is the budget for that line, and the second 
number indicates whether ‘‘beep” or “print'’ is turned on for that filter line (see Section 2.1 — The 
Filter Window). 


IV.3 — The Help File 
The help file, HELP.TXT, contains a brief description of how to use the system. The system displays 
the tutorial when you press the question-mark key ‘?’. 


IV.4—— The Key Ring 
The key ring file, KEYRING.TXT, contains the keys used by the system to decrypt the information that 
is received over the air. 


IV.5 — The Error File 

The error file, STDOUT.TXT, is written whenever the program exits. It normally does not contain any 
useful information; however, when the program exits to DOS unexpectedly, it leaves an error message 
in this file. Please record this message, and report it to the Boston ComminS ‘hotline’ at 
(617)-253-0007. 


IV.6 — Article Files 

Article files have names of the form TYMMDDN.NNN, where T indicates the type of the article (A for 
Associated Press, N for New York Times, or C for ComminS announcements); Y is the last digit of the 
year, MM is the month, pp is the date, and N.NNN is a four-digit serial number. Each article file 
contains a number indicating the number of lines of text, followed by a set of numbers that indicate 
which words in the article should be highlighted for display (see Section 2.3 — The Article Window), 
followed by the text of the article. 
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Appendix V— Your Responsibilities 

As a volunteer in the experiment to test the Boston Community Information System, you have several 
responsibilities. A copy of the agreement that you have signed is reproduced on the next page as 
Figure V-1. 


V.1— Your Responsibilities to the Boston ComminS Project 
We at the Boston CommiInS project want and need your active participation in the evaluation and 
testing of the CommInS hardware, software and documentation. This means that we would like you to 
e use the system to the fullest extent of its features, 
@ give us your thoughtful appraisal of the existing features, and 
e give us your suggestions for possible improvements. 


You may express these ideas, suggestions, and questions to us in many ways — in writing or by 
telephone — as often as you wish. However, at a minimum, ana even if you have provided feedback in 
other forms, you must fill out a one-page questionnaire (front and back sides) once a month. This is 
the minimal requirement for your continued participation in the experiment. 


V.2-- Your Responsibilities Regarding Use of the Information Received 

To conduct this unique experiment in the digital broadcast of news and information, MIT has entered 
into understandings and legai agreements with the Associated Press, the New York Times Company 
and Mead Data Central, Inc. As a volunteer in this experiment, you have agreed 


1.not to make more than one copy — in any form — of any information 
received; 

2. not to retain copies — in any form — of more than an “insubstantial part’ of 
the information received; 

3. not to transfer any of the information received — in any form — to third 
parties, whether or not for profit; and 

4. not to retain any of the information received from the New York Times — in 
any form — for more than 90 days. 


In view of the unique nature of this experiment, we feel that the responsibilities outlines above are 
reasonable. If you do not act in keeping with the letter and the spirit of the agreement, we will request 
that you return all loaned equipment and software to us immediately. 
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BostonComminS 253-0007 
C/o MIT Laboratory for Computer Science, Room NE43-403 
545 Technology Square, Cambridge, MA 02139 


Please print for the Recipient of MIT/New York Times data 
and Associated Press date: 


Full Name (printed): 


Legal Agreement with Mead Data Central, Inc. 


The above designated “Recipient” agrees that it will not retain any copies of date from the New 
York Times in any form, whether print, machine readable or otherwise for a period of more 
than 90 days, and that any such deta retained will be 1) limited to single copies, 2) never 
consist of more than an insubstantial part of the entire database made available to MIT, and 3) 
will not be transferred, whether or not for profit to any third party. It is agreed that all copies 
of such deta wil] be returned or destroyed earlier than the 90-day maximum retention per iod 
upon written request from MIT, The New York Times Company, or Mead Data Central, Inc. 


Agreed 
Signature of Recipient Date 


Understanding and Agreement with MiT 


Whether or not for profit, | understand and agree not to transfer in printed or electronic form 
any information derived from the Associated Press wire service via the Boston Commins project 
to any third party. 


| understand and agree that | must complete and return s questionnaire provided for that purpose 
to the Boston Commins Project once a month or else have to return the receiver and software to 
the project. 


| understand and agree that the software and hardware will remain the property of MIT and thet | 
must return all the materials used in this test of the Boston Commins system either (i) at the 
end of the experiment in approximately 12 months or (11) upon written notice from the project 
-- whichever comes first. 


| understand and agree that MIT has made no expressed nor implied guarantees to provide this 
information service without interuption throughout the duration of the exper imental test. 


Agreed 


Signature of Recipient Date 


Copies of this signed agreement will be held by (1) the Recipient, (ii) the Boston Commins 
Project at MIT, and Mead Data Central, Inc. 


Figure V-1: Text of Agreement 
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